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4.3  Transaction  Confirmation 

The  sovirce-form  of  all  retrievals  in  a job  is  listed  on 
the  on-line  printer  to  provide  a permanent  record  of  the 
retrievals  submitted  in  each  batch.  Errors  detected  during 
the  edit  pass  are  flagged  and  error  codes  axe  printed  in  the 
left  margin  opposite  the  invalid  statement. 

4.4  File  Indexing  Statistics  euid  Messages 

Errors  detected  by  the  file  indexing  function  are 
communicated  to  the  user  by  an  error  code  and  text  as 
appropriate.  As  indexing  operates  on  'retrievals  that  are 
essentially  error-free,  the  retrieval  statements  will  not  be 
printed  out.  The  clauses  that  activate  index  usage  (i.e., 
the  must-satisfy  clauses  referencing  indexed  fields)  are 
printed, 

T ^ 

Index  Processing  prints  the  number  of  candidate  records 
that  will  be  examined  by  Retrieval  Proper  to  determine  the 
qualifying  records. 

4.5  File  Analysis  and  Run  Optimization  Statistics 

# The  File  Analysis  Statistics  Capability  in  the  RASP 
component  provides  transactions  for  each  query  executed  in 
a RASP  execution^.  The  D5NAME  of  this  data  set  must  be  the 
data  file  name  plus  a T.  The  T is  added  to  ISAM  names;  the 
S is  replaced  by  T in  SAM  names.  To  obtain  transaction 
output,  the  DSNAME  roust  be  cataloged  amd  the  user  must 
specify  the  volume  serial  (VTRANS)  and  unit  (UTRANS)  in  the 
execution  procedure.  The  volvmae  may  be  any  direct  access 
volume.  If  the  data  set  exists  at  execution  time, 
transactions  will  be  added  (DISP^mOD) . If  it  does  not 
exist,  five  tracks  will  be  dynamically  allocated.  The  viser 
may  change  this  value  by  overriding  the  TRANST  DD  card  space 
parameter.  Transactions  are  written  as  fixed  length, 
unblocked,  50-byte  records.  The  format  (fixed)  arid  length 
'(50)  cannot  be  changed  but  the  user  may  cheuige  the  blocking 
factor  by  specifying  a DCB  BLKSIZE  in  the  TRANST  DD  card 
which  is  a multiple  of  50, 
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I If  the  user  specifies  a DSNAME  (TPANS)  in  the  TRANS  -DD 
card,  he  m\isf  supply  all' parameters  required  to  process  the 
data  set.  These  parameters  must  conform  to  the  requirements 
defined  here. 

The  Run' Optimization  Statistics  capability  provides  the 
user  with  statistical  data  reflecting  the  core  allocation 
during  a RASP  execution.  The  breakdown  of  the  statistics 
details  the  amount  of  core  used  for  user  subroutines  and 
tables,  queries,  stash  area,  I/O  buffers,  cuid  access 
methods.  It  also  includes  the  number  of.  BLDL  entries 
allocated  and  used  and  the  number  of  entries  required  for 
all  subroutines,  tables,  and  the  query  to  reside  in  core.  - 
Tiie  aunount  of  core  required  for  each  subroutine  aind  table 
and  the  query  to  reside  in  core  will  also  be  output.  If 
subroutines  and  taibles  are  rolled,  this  information  will  be 
output  with  the  causes  for  the  rolling  and  the  number  of 
times  it  occurred, 

Die  user  is  able  to  enter  override  parameters  for  the 
nuttiber  of  BLDL  entries  to  allocate,  and  the  size  of  the 
stash  area  to  be  used  for  storage  of  data  records. 

The  statistics  gathering  is  initiated  through  parameters 
entered  in  the  FARM  field  of  the  EXEC  card.  The  parameters 
and  tiieir  functions  are  as  follows: 

ROS  - Gather  and  output  Run  Optimization 

Statistics. 

NO  ROS  - Omit  statistics.  If  no  other  parameter 

is  used,  this  parameter  should  be 
omitted,  as  it  is  the  default. 

The  parameters  the  taser  may  supply  to  tailor  core 
allocation  are  as  follows: 

TCP»nK  - The  number  (n)  of  1000  (K)  bytes  to  allo- 


cate to  stash  area. 
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I 


TCB=»n  - Tne  number  (n)  cf  BLDL  entries  to  allo- 

cate. 

TCS  - Invalid  in  RASP. 

With  the  above  override  parameters,  run  optimization 
statistics  will  be  gathered  and  output  unless  NOROS  is  also 
entered.  „ . 

For  a more  detailed  description  of  the  capability,  see 
Volume  I,  Introduction  to  File  Concepts. 

4.6  Operator  ttessages 

The  RASP  component  is  designed  to  operate  with  minimum 
operator  intervention.  All  operator-system  communication  is 
performed  under  control  of  the  Operating  System. 
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Section  5 


JOB  HA  RAGE  KENT 


CSC  OK  15-7U,  Volume  VIII,  Job  PzeparaticE  Kacual, 
illustrates  the  use  cf  the  cataloged  procedure  IRASP.  It 
aay  he  used  for  single  file  retrievals  or  for  aerged-file 
retrievals.  The  "symbolic  parameter"  capability  prcvided  by 
the  OS/36C  is  utilized  by  the  procedure.  This  provides  the 
user  kith  a simple  method  of  designating  the  data  sets  to  be 
used  for  a giver  run. 

A standard  set  of  defaults  have  been  specified  for  the 
symbolic  parameters.  Assuming  that  all  data  file  and 
library  data  sets  have  been  cataloged  for  the  typical  run,' 
only  the  data  file  and  library  require  naming  at  rut  time. 
Eefault  parameters,  a listing  cf  the  IRASP  procedure  and  DD 
name  usage  are  provided  in  the  Job  Preparation  Kanual. 

The  procedure  has  been  defined  to  suffix  the  Danes  cf 
sequential  data  files  kith  "S,"  Index  Data  Sets  with  "X," 
and  user  libraries  with  "L, " This  convention  is  standard 
for  all  components  in  NIPS  360  EPS.  These  suffix  characters 
must  be  taken  into  consideration  when  cataloging  the  data 
sets  and  when  using  them  at  executicn  time. 


5.1  Checkpcint/R estart 

During  SAM  processing,  the  user  may  invoke  the  CS/360 
check  joint/ restart  capability  to  record  timed  or  end-of- 
volume  checkpoints.  If  checkpoints  are  needed  dcrirg  ISAM 
processing,  only  the  timed  option  .is  valid.  The 
check  jcint/restart  capability  should  only  he  used  during 
long-running  jcbs  using  the  execute  only  procedures.  (Note 
that  the  CS/360  step  restart  is  program  independent  ard  is 
not  the  topic  of  this  discussion.)  A detailed  description 
cf  the  CS/360  check/restart  capability  (which  is  utilized  in 
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effected  by  the  ABSENT  condition  would  cause  those  answer 
entry  records  to  be  eliainated  from  the  QRT.  This  situation 
Bight  arise  in  a case  where  mere  than  one  clause  is 
specified  for  an  IF  statement  such  as  in  the  fcllowing 
example.  (For  a description  on  the  SORT  stateaent  see 
section  2.  4.3.1.)  . 

IF  LOG  EC  PARIS  AND  (BEPSD  GT  1 OR  MEQPT  ABSENT). 

SORT  OIC,  HEQPT. 

In  this  example  it  is  desired  to  retrieve  those  records 
which  have  the  value  PARIS  in  the  field  LOG  with  the  further 
condition  that  either  the  number  of  major  equipment 
processed  field  is  greater  than  1 for  at  least  one  major 
equipment  subset  or  there  are  no  major  equipment  subsets  in 
the  record.  Any  records  which  qualify  as  a result  of  the 
HEQPT  ABSENT  clause  would  be  excluded  from  the  answer  set 
since  there  are  no  flagged  subsets  on  which  to  sort  those 
records  as  requested  by  the  SORT  stateaent. 

2. 4. 2. 3. 4 FONCTION  Operator 

Thte  FUNGTION  Operator  is  a conditional  clause  within  the 
IF  or  FURTHER  conditional  statement.  It  is  normally 
preceded  and  followed  by  one  of  the  logical  connectors  in 
the  statement.  The  use  of  the  FUNGTION  Operator  is 
designated  by  the  keyword  FUNGTION,  followed  by  the  name  of 
the  function  (the  user's  subroutine  which  may  be  enclosed  in 
pound  (•)  signs).  All  terns  following  the  function  name  and 
preceding  the  next  logical  connector  or  the  end  of  the 
statement  are  considered  as  part  of  the  parameter  list  to 
the  function  subroutine.  The  peurameters  may  consist  of 
field  names,  literals  and  system* provided  work  areas. 

Field  names  must  be  designated  by  prefixing  the  field 
name  with  an  ampersand  character.  Hithin  a parameter  list, 
fields  may  be  referenced  which,  belong  to  the  fixed  set  and 
one  periodic  set,  but  not  to  two  different  periodic  sets. 

System -provided  work  areas  will  be  designated  by  the 
system  labels  HORKI  through  HORK5.  No  distinction  is  made 
as  to  whether  a work  area  is  input  to  or  output  from  the 
subroutine. 
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i Any  ites  in  the  pacaaeter  list  which  is  not  a system 
work  area  or  is  not  prefaced  with  a plus  or  ampersand 
character  is  processed  as  a literal.  Literals  containing 
embedded  blanks  cr  commas  must  be  enclosed  in  quotes,  and 
literals  prefaced  with  a plus  or  minus  sign  ('•■  or  -)  must 
also  be  enclosed  in  quotes. 

Partial-field  notation  or  user  subroutine  conversion 
will  not  be  allowed  with  items  in  the  parameter  list. 

Example 

IP, ..AND  FUKCTION  GCD,  ♦ POI  NT,  6j/7  5N  1 2 3 2 3E  , 9^/8  ,GT, 

H0BX1  CR.  .. 

Comment:  Assume  that  GCD  is  a user-written  subroutine  which, 
given  two  latitude/longitude  points,  will  compute  the 
distance  between  the  two  points  and  compare  it  to  a given 
distance.  It  then  will  set  the  true/false  indicator 
according  to  the  given  condition.  The  computed  distance 
will  be  placed  in  a designated  work  area.  The  order  of 
parameters  is  Point  1,  Point  2,  distance,  qualifier  and  work 
area. 

In  this  example.  Point  1 is  a data  file  field  POINT. 
Point  2 is  a user-designated  point  69^75X1 2535E.  Note  that 
for  coordinates  in  a parameter  list,  conversion  to  internal 
form  is  not  automatic.  The  designated  distance  is  ^99  ^nd 
to  qualify,  the  computed  distance  must  satisfy  the  condition 
GT.  Note  here  that  GT  is  a requirement  of  the  subroutine 
GCD.  To  RASP,  GT  is  a literal  value  to  be  entered  as  a 
parameter  to  GCD.  The  computed  distance  would  be  placed  in 
the  system -provided  work  area  H0RK1. 

RASP  only  provides  an  interface  to  the  user-written 
function  subroutine.  The  number  of  parameters,  the  order  of 
parameters,  whether  parameters  can  be  omitted,  and  invalid 
parameters  (to  the  subroutine)  are  all  functions  of  the 
subroutine.  RASP  provides  the  data  and  control  for  the 
subroutine  in  the  order  in  which  they  appear  in  the  query. 
If  the  subroutine  will  allow  a variable  number  of 
parameters,  omission  within  a parameter  list  cacnct  be 
denoted  by  use  of  the  double  comma.  To  omit  a parameter 
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within  the  list  which  is  positional  in  nature,  an  omit  code 
which  is  recognized  by  the  subroutine  aust  be  used. 

There  are  several  rules  or  restrictions  which  the  user 
must  follow  to  use  the  FUNCTION  Operator.  Basically,  the 
FUNCTION  Operator  and  any  correlation  between  subroutine 
requirements  and  designated  input  are  the  user's 
responsibility.  If  the  following  rules  are  heeded,  there 
should  be  little  problem  using  the  FUNCTION  Operator. 

a.  A double  comma  cannot  be  used  to  indicate  omission 
of  a parameter. 

b.  Parameters  must  be  designated  in  the  order 

prescribed  by  the  subroutine. 

c.  Literal  values  in  the  parameter  list  are  subroutine 

related  and  not  data  field  related;  thus,  there 

will  not  be  any  automatic  conversion  by  subroutines 
of  literals  on  input. 

i d.  A literal  containing  embedded  blanks  or  commas,  or 

a literal  prefaced  with  a plus  or  minus  sign,  must 
be  enclosed  in  quotes. 

i e,  A literal  containing  any  nonnumeric  character  will 

be  passed  to  the  function  subroutine  as  EBCDIC 
characters;  this  includes  signed  numeric  values 
also,  because  the  plus  and  minus  signs  are  not 
interpreted  as  numeric  characters. 

f.  A literal  containing  all  numeric  characters  will  be 
converted  to  a binary  value  prior  to  being  passed 
to  the  function  subroutine.  Enclosure  of  an  all 
numeric  value  in  quotes  will  not  prevent  that  value 
from  being  converted  to  binary;  i.e.  , a literal 
must  contain  a nonnumeric  character  to  be  passed  to 
the  function  subroutine  as  an  alpha  literal. 

g.  Data  file  field  names  must  be  prefixed  with  an 
ampersand. 
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h.  The  paraaeter  list  to  the  FONCTION  Cperator 
subroutine  cannot  contain  the  word  AND  or  OR. 

2,4, 2,3. 5 FUNCTION  Operator  Usage  by  Index  Processing 
Analyzer  Routines 

The  PUNCTICN  operator  parameter  string  will  be  examined 
to  determine  if  a data  file  field,  or  fields  (a  data  field 
name  must  be  prefixed  by  an  ampersand)  , is  present.  If  so, 
and  any  field  so  referenced  is  indexed.  Index  Processing 
will  be  invcked.  If  no  field  name  is  given  in  the  FUNCTION 
operator  parameter  string,  or  no  field  is  an  index  field, 
index  usage  will  net  be  possible  for  that  clause.  Only  one 
indexed  field  pet  function  clause  (the  first  one 
encountered)  can  trigger  index  usage.  Any  other  indexed 
fields  are  treated  as  nenindexed  fields  in  the  analysis. 

The  indexed  field  used  in  a FUNCTION  operator  clause 
must  have  an  analyzer  routine  specified  for  it.  An  analyzer 
routine  is  designated  for  a field  in  an  Index  Specification 
run  (reference  Volume  II,  File  Structuring).  The  purpose  of 
the  analyzer  routine  is  to  analyze  the  FUNCTION  cperator 
parameters  for  Index  Processing.  The  analyzer  routine  will 
return  a value  (or  values)  which  Index  Processing  will  use 
as  arguments  when  searching  the  field's  index  information  in 
the  Index  Data  Set.  This  search  is  conducted  in  an  "equal" 
rela  tion sh i p only. 

Index  Processing  cannot  determine  how  the  FUNCTION 
operator  parameters  interrelate;  this  must  be  done  by  the 
analyzer  routine.  Therefore,  if  no  analyzer  routine  is 
specified  for  any  index  field.  Index  Processing  will  be 
negated  for  the  entire  FUNCTION  operator  clause. 

Index  Processing  only  provides  an  interface  to  tke  user- 
written  analyzer  subroutines,  exactly  as  RASP  provides  the 
interface  to  a Function  subroutine.  All  conditions,  rules, 
and  restrictions  regarding  Function  subroutines,  as 
described  in  Section  2.4.2. 2.3,  FUNCTION  Operator,  above, 
apply  to  an  analyzer  subroutine.  Section  2.8,  Writing  an 
Analyzer  Subroutine,  provides  information  for  calling 
sequence  and  parameters  needed. 
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FXECOTE  RET1  (LOC=CNAM)  . 

The  descending  sort  option  would  not  be  applied  tc  the  field 
CNAH,  and  the  results  of  the  retrieval  would  be  an  ascending 
sort  on  both  fields,  l)IC  and  CNAN. 

2.8  Writing  a FUNCTION  Operator  Subroutine 

This  subsection  is  prioarily  directed  towards  the 
progranaer  responsible  for  writing  the  subroutine.  The 
terninology  used  is  progra ane r-oriented.  Rased  on  the 
qualification  algorithn  established  by  the  user  (analyst) 
and  based  cn  any  additional  output  requireaents,  the 
progranaer  can  proceed  with  detailed  design  and  ceding  of 
the  subroutine.  The  subroutine  should  be  written  as  a 
single  root  sequent,  and  no  input  or  output  functions  should 
be  perforned  by  the  user  routine. 

The  Function  Operator  subroutine  should  be  coapiled  and 
link  edited  onto  the  Partitioned  lata  Set  Library,  which  is 
used  to  store  prograa  load  nodules  and  is  included  in  the 
SLIB  concatenation  of  data  sets  when  executing  RASP.  (This 
library  is  frequently  referred  to  as  the  User  File  Library 
or  Coaposite  Library  and  contains  retrievals,  RITs, 
conversion  tables  and  subroutines.) 

The  following  paragraphs  describe  the  interface  or 
linkage  required  for  Function  Operator  subroutines.  RASP 
uses  the  standard  NIPS  36()'  FFS  Subroutine  Supervisor 
(SDBSOP)  calling  sequence.  Input  formats  can  usually  be 
predetermined;  thus,  the  use  of  COBOL  and/or  FORTRAN  is 
feasible.  More  complex  and  variable  input  subroutines  will 
require  use  of  OS/360  Assembler  Language.  The  RASP  Function 
operator  capability  provides  the  interface  with  the  user 
routine  to  cause  execution  of  the  qualification  algorithn 
and  to  pass  generated  data  to  the  QRT  for  display  or  further 
processing  by  the  Output  Processor. 

Passed  Data  String  Format 

* RASP  will  "gather"  data  elements  of  the  Function 
Operator  parameter  list  as  prescribed  by  the  user  in  his 
query  and  will  formulate  a data  string  which  will  be  passed 
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to  the  named  subroutine.  In  this  string,  there  may  be 
elements  from  the  data  file,  from  literals  within  the 
parameter  list  or  from  the  system  work  areas.  All  numeric 
data  from  the  data  file  and  system  vozY.  areas,  and  from 
unsigned  numeric  literals,  will  be  passed  as  fullvord  binary 
values. 

i Signed  numeric  literals  are  passed  as  EBCDIC  literals 
and  must  be  converted  to  the  proper  form  by  the  subroutine. 
The  maximum  or  minimum  value  passed  as  a fullwcrd  binary 
value  is  ±2147483647.  The  passed  data  string  format  is  as 
follows: 

AABBCCDEPF. . FFCCBEPF.  . FF.  . . . 
vher  e 

A - Number  of  bytes  in  the  data  string 

B » Number  of  data  elements  in  the  data  string 

C - Number  of  bytes  (length)  of  the  data  element 

D « Type  of  data  element  code 
A = Alpha  (decimal) 

B « Binary 
C s Coordinate 

E * Set  code  (fl  = fixed  set,  1 = periodic  set,  2 * work 
area,  3 = literal) 

F * Data  value. 

C,  D,  E,  and  P are  repeated  for  each  item  in  the  parameter 
list.  If  a parameter  is  replaced  by  use  of  the  replacement 
capability,  the  length  and  mode  for  the  replaced  value  will 
be  used.  Obviously,  if  the  replacement  length  is  different 
from  the  original  length,  format  problems  will  be 
encountered  when  predefined  fixed  formats  are  used.  Note 
also  that  a $ mask  replacement  value  will  result  in  a data 
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eleaent  length  of  zero,  and  that  *ode  and  set  code  Mill  not 
be  set. 

Aligneent  Mill  not  be  guaranteed;  however,  if  all 
nuaeric  values  appear  first  in  the  parameter  list,  they  will 
be  fullword  aligned. 
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4.3  Transaction  Confirmation 

The  source-form  of  all  retrievals  in  a job  is  listed  on 
the  on-line  printer  to  provide  a permanent  record  of  the 
retrievals  submitted  in  each  batch.  Errors  detected  during 
the  edit  pass  are  flagged  and  error  codes  are  printed  in  the 
left  margin  opposite  the  invalid  statement. 

4.4  File  Indeiing  Statistics  and  Messages 

Errors  detected  by  the  file  indexing  function  are 
communicated  to  the  user  by  an  error  code  and  text  as 
appropriate.  As  indexing  operates  on  retrievals  that  are 
essentially  error-free,  the  retrieval  statements  will  not  be 
printed  out.  The  clauses  that  activate  index  usage  (i.e. , 
the  must-satisfy  clauses  referencing  indexed  fields)  are 
printed. 

Index  Processing  prints  the  number  of  candidate  records 
that  will  be  examined  by  Retrieval  Proper  to  determine  the 
gualifying  records. 

4.5  File  Analysis  and  Run  Optimization  Statistics 

» The  File  Analysis  Statistics  Capability  in  the  RASP 
component  provides  transactions  for  each  query  executed  in 
a RASP  execution.  The  data  set  name  (DSMANE)  of  this  data 
set  must  be  the  data  file  name  suffixed  by  a T.  The  T is 
added  to  ISAM  names;  the  S is  replaced  by  T in  SAB  names. 
To  obtain  transaction  output,  the  DSNABE  must  bs  cataloged 
and  the  user  must  specify  the  volume  aerial  (VTRAVS)  and 
unit  (DTRANS)  in  the  execution  procedure.  The  volume  may  be 
any  direct  access  volume. 

i If  the  transaction  data  set  exists  at  execution  time, 
transactions  will  be  added  (CISP>NOD)  . If  it  docs  not 
exist,  a five  track  data  set  will  be  dynamically  allocated. 
The  user  may  change  the  allocation  value  by  overriding  the 
TBAMST  DD  card  space  parameter.  Transactions  are  written  as 
fixed  length,  unblocked,  50-byte  records.  The  format 
(fixed)  and  length  (50)  cannot  be  changed  but  the  user  may 
change  the  blocking  factor  by  specifying  a DCS  BLKSIZE  in 
the  TBANST  DD  card  which  is  a multiple  of  50. 
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« If  the  user  specifies  a DSNAME  (TRANS)  in  the  TEAKS  DD 
card,  he  aust  supply  all  parameters  required  tc  {.rocess  the 
data  set.  These  parameters  must  conform  to  the  requirements 
defined  above 

The  Run  Optimization  Statistics  capability  provides  the 
user  with  statistical  data  reflecting  the  core  allocation 
during  a RASP  execution.  The  breakdown  of  the  statistics 
details  the  amount  of  core  used  for  user  subroutines  and 
tables,  queries,  stash  area,  I/O  buffers,  and  access 
methods.  It  also  includes  the  number  of  BIDL  entries 
allocated  and  used  and  the  number  of  entries  required  for 
all  subroutines,  tables,  and  the  query  to  reside  in  core. 
The  amount  of  core  required  for  each  subroutine  and  table 
and  the  query  to  reside  in  core  will  also  be  output.  If 
subroutines  and  tables  are  rolled,  this  information  will  be 
output  with  the  causes  for  the  rolling  and  the  number  of 
tines  it  occurred. 

The  user  is  able  to  enter  override  parameters  for  the 
number  of  BIDL  entries  to  allocate,  and  the  size  of  the 
stash  area  to  be  used  for  storage  of  data  records. 

The  statistics  gathering  is  initiated  through  parameters 
entered  in  the  FARM  field  of  the  EXEC  card.  The  parameters 
and  their  functions  are  as  follows: 

ROS  - Gather  and  output  Run  Cptimization 

Statistics. 

NOROS  - emit  statistics.  If  no  other  parameter 

is  used,  this  parameter  should  be 
omitted,  as  it  is  the  default. 

The  parameters  the  user  nay  supply  to  tailcr  core 
allocation  are  as  fellows: 

TCP=nK  - The  number  (n)  of  1000  (K)  bytes  to  allo- 

cate to  stash  area. 
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j.  Dyriamic  analysis  of  retrieval  logic  fo  (ietermine  if 
index  processing  is  applicable.  If  so,  PASF  will 
restrict  the  detailed  logic  examination  tc  the 
potential  qualifying  reccrds  as  indicated  by  index 
Processing. 

k.  Selection  cf  only  desired  pericdic  sets  with  ^ he 
fixed  set  rather  than  whole  qualifying  logical 
blocks 

l.  The  ability  tc  use  user-written  subroutines  to 
qualify  data  through  use  of  the  ^uncticn  Cperatoi 

D! . The  ability  to  pass  information  generated  by  the 
user-written  subroutines  to  OP  through  use  of 
system-provided  work  areas 

n.  The  ability  ♦•o  change  operands  at  execution  tim-^ 
through  use  of  the  skeleton  query  feature 

o.  The  ability  tc  change  sort  field  designations  a*- 
execution  time  through  use  cf  the  skeleton  query 
feature 


Petrieval  specifications  may  be  from  card  input  cr  from 
specifications  stored  as  executable  modules  on  the  system  or 
a file  library.  Tn  addition,  the  Terminal  Prccessing 
component  uses  PASP  tc  process  queries  from  a display 
con  sole. 

# PASP  will  retrieve  from  data  files  organized 
sequentially  on  magnetic  tape  cr  as  an  indexed  sequential 
data  set  resident  on  a Direct  Access  Storage  Device  (DASP). 
PASP  will  also  retrieve  data  from  a Virtual  Storage  Access 
Method  (VSAM)  file. 

1.1  Secondary  Indexing 

Secondary  Indexing  provides  the  user  the  capability  <-o 
index  a data  file  by  the  contents  cf  a field  other  than  the 
Pecotd  ID.  The  primary  purpose  of  the  capability  is  to 
provide  a faster  response  time  for  qualifying  data  records 
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■iurinq  r"'*- rie  val.  Thf*  principles;  of  Secondary  Indexing  are 
described  in  Volnne  I,  Introduction  to  File  Concepts. 


'"he  decision  whether  file  indexing  informaticn  is 
actually  usahle  is  made  cn  the  basis  of  user- supplied 
retrieval  logic  at  run  time.  PA£P  determines  if  an  Index 
Pa'"a  S«t  is  associated  with  the  data  file  based  cn  the 
-»xistGnc«  cf  Index  Descrip<-or  Pecerds  in  the  data  file.  If 
thort  are  none,  RASE  proceeds  with  its  regular  furctions  of 
retrieving  tecerds. 


If  indexes  have  beer  specifiid  for  the  file,  RASE  will 
invoke  the  Index  Processing  function  to  determine  if 
indexing  can  te  utilized  or  whether  the  entire  data  file 
must  be  examined.  Index  Processing  decides  this  based  on 
the  logical  criteria  for  data  selecticn  as  provided  by  the 
IF  statements.  The  format  of  this  statement  and  the 
criteria  used  in  determining  if  indexing  can  be  utilized  are 
described  in  section  2. 4.2.  2. 


"nd^x  Prccessing  returns  to  RASP  with  an  indication  of 
whether  ♦•he  entire  data  file  must  be  searched,  or  whether, 
oased  on  the  user  Icgic,  only  certain  records  could  pcssibly 
qualify.  The  keys  cf  these  tecerds  are  passed  to  Retrieval 
Proper  and  used  to  access  the  records  and  examine  tfem  in 
detail.  By  restricting  the  search  to  just  these  records 
that  could  qualify,  RASP  can  save  ♦•he  time  otherwise 
Lt'guired  to  access  and  ‘>xamine  records  that  cculd  not 
possibly  qualify. 


1.2  Keyword  Indexing 

•"ho  Keyword  capability  is  a text- retrieval  capability 
that  provides  a method  by  which  records  can  be  accessed  and 
retrieved  based  upon  the  known  contents  of  variable  length 
•jc  tex^-  data  fields.  vTust  as  secondary  indexing  allows 
access  of  only  those  records  knewn  to  contain  the  fixed 
length  fields  of  interest,  keyword  indexing  allcws  retrieval 
of  records  based  cn  the  presence  of  "keywords"  within  a 
ti“ld.  The  selection  of  records  based  on  these  "keywords" 
is  accomplished  via  a KEYSORD  statement  which  is  included  in 
the  qu^ry.  It  is  described  in  paragraph  2. 4. 2. 2.  The 
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principles  cf  keyword  indexing  are  described  in  Volume  T, 
Introduction  to  File  Concepts. 

Prior  to  employing  keyword  retrieval,  th’  fields  to  b ^ 
examined  must  have  been  defined  as  keyword  indexed  fields 
either  through  File  Structuring  or  the  Ind-^x  Specification 
utility  (see  Volume  II,  File  Structuring,  Index  Definition 
for  Keyword  Fields  fcr  the  methods  cf  defining  keyword 
indexed  fields).  Depending  on  when  the  indexes  were 
specified,  either  File  Maintenance  or  the  utility  will 
maintain  the  index  data  set  with  the  fields  and  their 
designated  keyword  values.  (See  Volume  T,  Introduction  to 
File  Concepts,  Keyword  Indexing  Capability  fcr  keyword 
qualification  requirements.)  The  usee  determines  what 
values  in  the  field  qualify  as  keywords  and  front  this 
selection  bases  the  arguments  for  his  retrieval. 

Keyword  processing  is  initiated  by  including  a KEYWORD 
statement  in  the  query.  The  KEYWORC  statement  operates  on 
the  same  level  as  the  secondary  LIMIT  statement.  Cnly  one 
KEYWCRD  statement  per  query  is  allowed.  Structurally  and 
functionally,  the  statement  is  similar  to  the  IF  statement. 
Qualification  is  at  the  record  level;  that  is,  subsets  are 
not  flagged  although  qualification  may  be  the  result 
interrogation  of  periodic  data. 

If  keyword  qualification  produces  a candidate  list  or 
qualifying  records  hut  secondary  indexing  is  found 
unfeasible  due  to  a low  percentage  cf  fields  in  the  query 
being  indexed,  the  keyword  list  becomes  the  qualifying  list 
for  the  query.  Otherwise,  the  list  of  qualifying  records 
from  the  KEYWORD  statement  is  merged  with  the  list  of 
qualifying  records  from  the  secondary  indexed  fields  in  the 
IF  statement  to  produce  ore  final  list  containing  only  those 
record  IDs  that  contain  both  qualifying  keyword  and 
secondary  indexed  fields.  This  list  is  passed  to  the 
retrieval  routine  to  indicate  what  records  are  to  be 
accessed  and  retrieved. 

If  either  source  produces  no  candidates,  the  retrieval 
is  terminated  with  an  advisory  message. 
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1,?  System  Flow 

FASP  has  three  sections:  the  Input  Processor  section, 
the  Retrieval  Proper  section,  and  the  Sort  secticn.  The 
flow  wi*-hin  each  secticn  is  discussed  briefly  in  the 
follcwinq  paragraphs. 

■^he  Input  Processor  section  reads  the  input  strear.  It 
edit'5  each  statement  and  restructures  communicaticn  records 
tor  the  r-»st  of  the  component.  It  extracts  tte  required 
information  from  the  Pile  Pormat  Table,  resolves  all  field 
itamo  addresses  and  references,  and  places  those  data  values 
conv-'rted  ty  conversion  subroutines  in  the  communication 
tecoids.  It  also  applies  an  algorithm  to  restructure  the 
conditional  logic  irto  a bit  pattern  which  can  be  more 
readily  interrogated  using  programmed  logic.  Finally,  it 
conv'^rts  the  retrieval  statements  into  macros  which  are 
jsserbled  and  link-edited  by  OS/360  to  produce  an  executable 
load  module.  ""he  resulting  executable  retrieval  is  stored 
on  the  Permanent  or  Temporary  Retriewal  Library. 

'^he  Retrieval  Proper  section  reads  the  communication 
records  and  calls  and  executes  the  cede  stored  on  the 
Permanent  or  Temporary  Retrieval  Library.  checks  tc  see 

Lf  ♦he  retrieval,  the  required  subroutines,  and  the  first 
data  set  to  be  retrieved  against  are  available. 

If  either  cf  the  first  twe  are  not  available,  an 

advisory  message  is  issued,  and  the  jcb  is  terminated.  If 

♦he  data  set  is  not  available,  the  operator  is  notified,  and 
appropriate  operator  acticn  must  be  taken. 

Turing  initialization.  Retrieval  Proper  determines 
whether  an  Index  Eata  Set  is  associated  with  the  file.  If 
so,  it  calls  the  Index  Processing  function  which  will 

determine  if  indexing  information  can  be  utilized.  If  so, 
a list  of  potential  qualifiers,  called  candidates,  will  be 
presented  to  Retrieval  Proper  which  will  access  only  those 
records. 

After  all  initialization  and  Index  Processing  functions 
ate  completed.  Retrieval  Proper  is  read  to  pass  the 

retrieval  Icgic  against  data  records.  Based  on  the  results 


6 CH-3 


JHIS  PACE  IS  BEST  QUALITY  PRAmCAKa 
mOQP,XliHH,SHg)10i>D.C  ^ 


nETPTFVAL  ANE  SC?T 


IFCCFSSnp  (PASF) 


3ffoc*eJ  by  ABSENT  condition  would  caujo  ♦•hor,-’  answer 

entry  records  to  be  eliminated  frcm  t QPT.  '"his  sitJ.ition 
might  arise  in  a case  wh-^r^  ircre  tiian  on^'  clausa  i-. 
specified  £ot  an  IF  statement  such  as  in  ‘■he  fcllcwing 
example.  ('’cr  a description  cn  the  SCR"^  statement  see 
sec  ti  or  2.  4.  ? . 1 .)  . 

T'='  LOC  FC  FAPT5  ANE  (FFFSP  1 c?  ARSFET). 

SOP?  nic,  N20PT. 

In  this  example  it  is  desired  to  retri'^ve  these  records 
which  have  ♦■he  value  n^pje  i-be  field  LCC  with  the  furth"^!' 
condition  ^hat  cither  the  number  of  major  equipnen* 
processed  field  is  greater  than  1 for  at  l^ant  one  major 
equipment  subset  or  *here  are  no  major  eguipm»nt  subsets  in 
the  record.  Any  records  which  qualify  as  a result  of  th-^ 
ADS’^'NT  clause  would  be  excluded  from  the  answer  se*: 
since  there  are  r.c  flagged  subsets  on  which  sort  those 
records  as  reguon-ed  by  the  SOR"'  statement, 

2.a._.'>.4  FUNCTION  Operator 

The  ’’UNCTION  Operator  is  a cor.ditional  clause  within  the 
I-  or  FUPTHEP  conditional  statement.  It  is  iicrraally 
preceded  and  followed  by  one  of  the  logical  connectors  in 
♦■he  statement.  The  use  of  the  FUNCTION  Operator  is 
designated  by  the  keyword  FUNCTION,  followed  by  the  name  of 
the  function  (the  user's  subroutine  which  may  be  enclosed  in 
pound  (#)  signs).  All  terms  following  the  function  name  and 
preceding  the  next  logical  connector  or  the  end  of  th-^ 
statement  are  considered  as  part  of  the  parameter  1 is*  to 
the  function  subroutine.  The  parameters  may  consist  of 
field  names,  literals  and  s ystera -pr ov ided  work  areas. 

Field  names  must  be  designated  by  prefixing  ♦le  field 
name  wi*h  an  ampersand  character.  hithin  a parameter  lis*, 
fields  may  be  referenced  which,  belong  to  the  fixed  set  and 
one  periodic  set,  but  net  to  two  different  periodic  sets. 

S ystem- provided  work  areas  will  be  designated  by  th '! 
syst‘=‘m  labels  W0PK1  through  W0PK5.  No  distinction  is  made 
as  to  whether  a work  area  is  input  tc  or  output  from  the 
sub  ro  utine. 
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* Ary  iteir  in  the  list  which  is  net  a system 
work  area  or  is  not  prefaced  with  an  ampersand  character  is 
processed  as  a literal.  Literals  centaining  erateddsd  blanks 
or  commas  must  be  enclosed  in  quotes,  and  literals  prefaced 
with  a plus  or  minus  sign  (t  or  -)  must  also  be  enclcsed  in 
j uo  t j s . 


i’ar ^ial-f ield  notation  or  user  subroutine  conversion 
will  not  be  allowed  with  items  in  the  parameter  list. 

Exani le 

« IF. ..AND  FUNCTION  CCD,  RPCI  KT  ,6JJ75  N1  2 12  E ,GT  , 

WCFKl  CR 

comm,  nt;  Assume  that  GCP  is  a user-wr it ‘•e n subroutine  which, 
give’  two  latitude/lcnqitude  feints,  will  cempute  the 
iistanc‘’  between  the  two  point’s  and  compare  it  to  a given 
listinco.  It  then  will  set  t^p  indicator 

accoiding  tc  the  given  cerdition.  The  computed  distance 
will  be  placed  in  a d®signatel  work  area.  Tbe  ctder  of 
parareters  is  Point  1,  Pcint  2,  distance,  qualifier  and  wotk 
> r^a . 

In  ♦■his  example.  Point  1 is  a data  fil®  field  POINT. 
''oir>.»  2 is  a user -des igna  ♦•ed  pcirt  6)>75N^253'jE.  Note  that 

tor  coordinates  in  a parara^^-er  list,  conversion  ♦■c  internal 
form  is  net  automatic.  The  designated  distance  is  and 

‘o  giialify,  the  computed  distance  test  satisfy  the  condition 
'*■.  Note*  hor'=  tha*-  GT  is  a reguirenent  of  the  subreutine 
OCU.  To  FAST,  GT  is  a literal  value  to  be  entered  as  a 
pa L a ii! -‘‘■er  to  GCC.  The  computed  distance  would  be  placed  in 
‘he  ; ystom- prev  ided  werk  area  WOPN1. 

“ASP  only  provides  an  in^-erface  to  tha  usor-writter. 
: UPC  "ion  subroutine.  The  number  of  parameters,  the  erder  of 
f’-n  aireters,  whether  parameters  car  be  omitted,  and  invalid 
{dramet,ai:s  (to  the  subroutine)  are  all  functions  cf  the 
subrc'utine.  RASP  provides  the  data  and  control  for  the 
subroutine  in  the  order  in  which  ,they  appear  in  the  query. 
If  * he  subroutine  will  allow  a variable  number  of 
i ra  mete  rs , omission  within  a parameter  list  cannot  be 
deno* ‘=d  by  use  cf  the  double  comma.  Tc  emit  a parameter 
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«2.10  SYSEATS  FUNCTION  Subroutine 

SYSDATS  is  a FTI  ^CTICN  subroutine  which  allows  the  user 
to  access  the  current  system  date  for  use  in  retrieval.  by 
usinq  the  subroutine,  records  can  he  retrievei  based  cr  th^ 
logical  relation  between  a file  date  field  and  ♦ihe  curren* 
system  date.  The  relationship  is  establishad  by  applying  an 
adiustment  factor  tc  the  system  date  and  then  ♦•esting  this 
adjusted  date  against  the  file  data  field  for  thf  sjecifiel 
relat ionship. 

#2.10.1  SYSDATS  Format 

The  format  for  using  SYSDATS  is: 

FUhCTICN  SYSDATS  relop  Sfld  'adjl*  'adj?* 

where : 

FUNCTION  (reguired)  --  used  tc  identify  the  string  as 
'"UNCTION  items. 

SYSDATS  (required)  — used  to  identify  the  FUNCTI'^N 
subroutine  being  invoked. 

relop  (required)  — the  relational  operator  specifying 
♦•he  type  of  test  tc  bo  perfcrmed.  The  valid  operators 
are  EQ , NE,  IT,  LE,  GT,  GE,  ET,  and  NE.  Each  of  th3so 
operators  is  a standard  'JASP  relational  operator  except 
for  NB,  which  represents  NOT  ET. 

fifld  (required)  --  the  file  fieldname  which  contains  the 
date  value.  The  field  must  be  a six  character 
ALPHA/DECIEAL  field  in  the  form  of  YYMMDD.  The  field 
names  must  he  preceeded  by  an  ampersand  (S)  . 

’adjl'  (required)  --  the  adjustment  factor  to  be  applied 
to  the  system  date.  The  format  of  the  adjustment  is: 

• snnyFnnmornDA ' 
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w h“r »: 

s (Officinal)  - a sign  (•*■  or  -)  indicating  that  the 
adjustment  is  to  be  upward  ( ♦)  or  downward  (-)  . 
Hhen  cnittcd,  the  adjust  sent  is  assumed  to  be 
upward. 

nn  (required)  -at  tc  2 digit  number  specifying 
the  number  of  years,  raenths  and/or  days  the  systom 
date  is  to  be  adjusted.  The  number  can  te  any 
number  from  zero  (0)  to  99. 

fR  - indicates  an  adjustnert-  in  years. 

flC  - indicates  an  adjustment  in  months. 

DA  - indicates  an  adjustment  in  days. 

The  adjustment  factor  must  be  enclosed  in  single  quotes. 
The  adjustment-  nay  be  specified  using  one  or  more  of  the 
time  units,  for  example; 

'-7 DA*  - is  7 days  prior  to  the  current  system 
date. 

'♦3M07CA*  - is  3 months  and  7 days  after 

the  current  system  date. 

' lypiDA'  - is  1 year  and  1 day  after  the 

current  system  date,  upward  adjustment  assumed. 

If  the  current-  system  date  is  to  be  used  without 
adjustment,  the  user  would  code  the  adjustment  as  zero 
(0)  . 

The  adjustment  factor  as  applied  must  not  cause  the 
system  date  to  overlap  the  century. 

'adj2t  (optional)  --  is  a second  adjustment  factor  to  be 
applied  tc  the  current  system  date  only  when  either  the 
DT  or  the  NB  relaticnal  operator  is  being  used.  The 
format  *adj2'  is  the  same  as  the  format  of  'adji'.  When 
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AND  FUNCTICN  SYEDAIS  LE  *6(10'. 

This  example  hill  retrieve  records  where  PDATE  is  less  than 
or  e'jual  tc  5 months  after  the  current  system  date. 

FUPTHES  FUNCTION  SYSOATS  DT  R F C F ’-6CA'  *0’. 

This  example  will  retrieve  records  where  FOATF  rantjes  from 
6 days  prior  to  and  up  to  the  current  system  date. 
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# P ASP  will  retrieve  from  data  filo.s  orqaniz*^! 

sequentially  on  mdqnotic  <-ape  as  single  data  files  cr  as 

concatenated  segments  cf  a data  file,  or  as  either  an 

indexed  sequertial  data  se'*'  or  a virtual  storage  access  data 
set  resident  cn  a Direct  Access  Storage  Device  (DASC). 

1.1  Data  Files 

# PASP  will  retrieve  from  data  files  organize  E 

sequentially  cn  magnetic  tape  or  as  either  an  irdexei 

sequ-=ntial  or  a virtual  storage  access  data  set  resident  on 
a Direct  Access  Storage  Device  (lASD).  The  data  set  name 
for  the  data  files  iray  te  a qualified  data  set  name  up  to  44 
characters  in  length.  when  retrieving  from  a tape  data 

file,  the  Cueued  Sequertial  Access  Method  (QSAH)  will  he 
used  as  will  the  Queued  Index  Sequential  Access  fethod 

(QISAM)  when  retrieving  from  an  ISAM  data  file  cr  the 
Virtual  Storage  Access  Me«-hcd  (VSAM)  from  a VSAM  data  file 
re.aidinq  on  a Direct  Access  storage  Device.  The  F^T,  which 
describes  the  logical  record  structure  cf  the  data  file,  is 
storr-d  as  a part  of  the  da^a  file.. 

3.2  Index  Data  Set 

This  data  set  is  the  repository  of  all  indexing 
information  for  its  asscciated  data  file.  The  da+a  set  nam  * 
is  the  data  file's  qualified  or  unqualified  name,  less  the 
"S"  tor  SAM  files,  with  the  suffix  "y.ii 

3.-3  Procedure  Library 

The  Procedure  Library  contains,  among  others,  a set  of 
Job  Control  statements  for  RASP  that  have  h'»en  placed  in  a 
special  data  set  ( S YS 1 .PROCLl  B)  and  that  can  be  re'rieved  by 
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i.amii.q  it  in  th*  OS/3  6;0  pxpcut  € (EXEC)  sta  re  ff'^n  t . The 
proc  dure,  XFA5P,  contains  the  job  and  program  information, 
iara  cha  racteristics  and  device  requirements  used  by  the 
operating  sytem  to  regulate  the  execution  cf  FASP  jot  steps, 
allocate  input/cutput  resources,  obtain  and  dispose  cf  data, 
and  communicate  with  the  operator. 

■’.4  Program  Library 

""he  Program  Library  is  a partitioned  data  set  that 
coiiT  iins  us6r-writt<=n  subroutines  and  tables,  retrievals  in 
a program  format  suitable  for  loading  into  main  storage  for 
axocution,  the  FASP  programs  themselves,  and  standard 
sys^ ''m-supplied  conversion  subroutines  and  Tables.  The 
library  data  set  name  may  be  a qualified  data  set  name  up  to 
44  characters  in  length. 

3.5  r.  ASP  ccntrcl  and  Source  Statenects 

^he  PA5P  Contrcl  and  Source  statements  define  the 
-nvir.cr.menT  for  the  FASP  job,  provide  the  logical  conditions 
for  one  or  more  retrievals,  and  specify  the  library 
main ronance  action  to  b“  taken  against  the  Permanent 
Potrieval  library,  a subset  of  the  Program  Library. 

^.6  : verridirg  Index  Processing 

Index  Processing  normally  activates  th^  candidate-access 
mod‘^  it  at  leasT  75?  of  all  retrievals  in  one  run  can 
uTilize  index  infermaticn.  The  user  can  override  this  by 
coding  an  entry  on  the  EXEC  statement.  The  ertty  is 
PAPN^' TNPEX^yxxX’ , where  XXXX  is  cne  of  the  following: 

:o  - Override  Index  Ftocessirg  entirely.  PASP 

will  not  activate  Index  Processing  at 
all. 

r'VFPY  - Allow  the*  candidate-access  mode  cnly  if 

all  retrievals  in  a batch  can  utilize 
index  infcrmaticn. 

ANY  - Allow  the  candidate-access  mode  if  any 

retrieval  in  the  batch  can  utilize  index 
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inf  or  mat  icn,  r^ajardloss  of  th3  iiUnb‘=r  of 
universal  ijuerios. 

However,  the  presenc<^  of  a KEYWORD  sta^eitont  in  the- 
retrieval  n'^gates  the  EAP*1  override  so  that  indexing  is 
always  invoked  when  the  KEYWC’D  statemf^n^’  is  found. 


Mil  nrn  If  BCST  QUAKtlY  FRA'CTICAfilil. 

ga^it  tjjftusm)  lo  ia),a 
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OtITPUT 


■hi:j  s<=ctior.  pLovi'?<?s  a ij-ancral  ct  the 

various  fotirn  cf  output. 

4.1  Qualityinq  Data  File  (QDF) 

"he  yualifyinq  Eata  ’'ile  (QD’=')  is  written,  using  the 
ii.asic  Sequential  Access  (BSAM),  as  a sequential  file  o£ 
variable  length  blocked  records  cn  a Direct  Access  Storage 
Device  in  record  ID  sequence,  Fach  logical  klcck  which 
sdtirfies  the  conditions  cf  ere  or  mote  retrievals  is 
wri*-*:‘=>r  on  the  file.  A data  record  is  written  only  once. 
The  yCF  is  net  sorted  and  contairs  rc  sett  keys. 

'he  OD"  also  includes  tecetds  which  con<-ain  file 
classification,  file  control  data,  the  Fr.s  logic  statements, 
ind  cource- tc tir  retrieval  statements  for  each  file. 

4.2  Qualifying  Pecord  Table  <QBT) 

'ho  OPT  is  a sequential  file  consisting  of  variable- 
leny‘ h blocked  records.  One  of  the  primary  records  in  this 
tabl*.  consists  cf  a sort  key  and  a pointer  to  the  fixed 
fieli!  of  a data  record  on  the  Qualifying  Data  '=’il€  which 
sati:  tied  the  cenditiens  cf  a retrieval.  There  is  at  least 
one  such  entry  for  each  record  that  qualified.  Also 
included  in  each  QRT  entry  will  he  information  identifying 
the  subsets  in  each  data  record  which  caused  the  retrieval 
to  b<'  satisfied.  There  are  also  records  identifying  the 
fil-Oi  used  and  records  identifying  the  PIT  names  used. 
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4.3  Transaction  Confirmation 

Th«  source-form  of  all  re*-rievals  in  a -job  is  on 

the  on-lin*;  printer  to  provide  a permanent  record  of 
retrievals  submitted  in  ‘^ach  batch.  Frrors  detected  durirq 
•■he  edit  pass  are  flaqqed  and  error  codes  are  printed  in  th-’ 
left  margin  opposite  the  .invalid  statement. 

4.4  File  Indexing  Statistics  and  Messages 

■rrors  detected  by  +•  he  file  indexing  function  ar'^ 
communicated  to  th“  user  by  an  error  code  and  text  as 
appropriate.  As  indexing  operates  cn  retrievals  that  are 
essentially  error-free,  ♦'he  retrieval  statements  will  not  be 
prin"-«^d  out.  The  clauses  that  activate  index  usage  (i.e., 
the  must-satisfy  clauses  referencing  indexed  fields)  are 
prin*  ed. 


Index  Processing  prints  the  number  of  candidate  records 
<-ha«-  will  be  examined  by  Retrieval  Proper  to  determine  th-> 
jualifying  records. 


4.5  File  Analysis  and  Run  Optimization  Statistics 

# '’’he  Pile  Analysis  Statistics  Capability  in  the  FASp 

component  provides  transactions  fet  each  query  executed  in 
a RASP  execution.  The  data  set  name  (dsnamF)  of  this  data 
set  mus+  be  the  data  file  name  suffixed  by  a T.  The  T is 
added  to  ISAM  and  VSAM  nases;  the  Sis  replaced  by  T in  SAM 
names.  To  obtain  transaction  output,  the  DSNAME  must  be 
cataloged  and  the  user  must  specify  the  volume  serial 
(VTRANS)  and  unit  (UTRANS)  in  the  execution  procedure.  The 
volume  may  be  any  direct  acce.ss  volume. 


If  the  transaction  data  set  exists  at  execution  time, 
transactions  will  fe  added  (DISF=MOn)  . If  it  dees  not 
exist,  a five  track  data  set  will  be  dynamically  allocated. 
The  user  may  change  the  allocation  value  by  overriding  ♦h.» 
TRANST  PD  card  space  parameter.  Transactions  are  written  as 
fixed  length,  unblccked,  50-hyte  records.  The  formal 
(fixed)  and  length  (50)  cannot  te  changed  but  ♦■he  user  may 
change  the  blocking  factor  by  specifying  a rCB  PLKEI'ZF  in 
♦he  TRANST  DD  card  which  is  a multiple  cf  50. 
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:f  *-he  user  spccitics  , ESNA^IF  (TRANS)  in  ^Yg  TPANS  DD 
card,  h-»  supply  all  parameters  required  to  process  the 

id*d  3e«- . These  parameters  must  ccnfcrm  to  the  requirements 
defined  above 

"'he  Pun  Cptimizaticn  Statistics  capafcili^-y  provides  the 
user  with  statistical  data  reflecting  the  core  allocation 
vlurinq  a PASF  execution.  The  kreakdcvn  of  the  statistics 
de«-ails  the  ascunt  cf  core  used  fcr  user  subroutines  and 
tables,  queries,  stash  area,  I/O  buffers,  and  access 
methods.  It  also  includes  the  number  of  BLCl  entries 
allocated  and  used  and  the  number  of  entries  required  for 
all  subroutines,  tables,  and  the  query  to  reside  in  core. 
The  amoun*  cf  core  required  for  each  subroutine  and  table 
and  ♦he  query  tc  reside  in  core  will  also  be  output.  Tf 
subroutines  and  tables  are  rolled,  this  information  will  be 
output  with  the  causes  fcr  the  rolling  and  the  number  of 
times  it  occurred. 

he  user  is  able  tc  enter  cverride  parameters  for  the 
tiurab^'r  of  ELEL  entries  to  allocate,  and  the  size  of  the 
stash  ar«a  ♦o  be  used  for  storage  of  data  records. 

"he  statistics  Gathering  is  initiated  through  parameters 
entfied  in  the  PARli  field  of  the  card.  '’'he  parameters 

and  their  functions  are  as  follows: 

'OS  - Gather  and  output  Run  Optiiization 

Stati  sties. 

NCPOS  - emit  statistics.  If  r.o  other  patameter 

is  used,  this  parameter  should  be 
emitted,  as  it  is  the  default. 

The  parameters  the  user  may  supply  to  taller  core 
allocation  ate  as  fellows; 

'■CP=nK  - The  number  (n)  cf  1000  (K)  bytes  to  allo- 

cate to  stash  area. 


